﻿<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head>
	<link rel="Stylesheet" type="text/css" media="screen" href="Screen.css" />
  <title>STP_SetPortPriority</title>
</head>
<body>
	<h3>STP_SetPortPriority</h3>
	<hr />
<pre>
void STP_SetPortPriority
(
    STP_BRIDGE*    bridge,
    unsigned int   portIndex,
    unsigned int   treeIndex,
    unsigned char  portPriority,
    unsigned int   timestamp
);
</pre>
	<h4>
		Summary</h4>
	<p>
		Sets the priority component - most significant 4 bits - of the portId.</p>
	<h4>
		Parameters</h4>
	<dl>
		<dt>bridge</dt>
		<dd>Pointer to a STP_BRIDGE object, obtained from <a href="STP_CreateBridge.html">
			STP_CreateBridge</a>.</dd>
		<dt>portIndex</dt>
		<dd>The zero-based index of the port.</dd>
		<dt>treeIndex</dt>
		<dd>The zero-based index of the spanning tree for which the port priority is to be set. For 
			STP or RSTP, this must be zero. For MSTP, this must be zero for the CIST, or 1..64 for an 
			MSTI.</dd>
		<dt>portPriority</dt>
		<dd>A value between 0 and 240, in steps of 16.</dd>
		<dt>timestamp</dt>
		<dd>A timestamp used for the debug log. </dd>
	</dl>
	<h4>
		Remarks</h4>
	<p>
		See §13.27.46 in 
		802.1Q-2018 for more details.</p>
		<p>
			Execution of this function is a potentially lengthy process. 
			It may call various callbacks multiple times.</p>
	<p>
			This function may not be called from within an <a href="STP_CALLBACKS.html">STP callback</a>.</p>

</body>
</html>
